AEGetSpecialHandler

Gets a specified special handler

#include <AppleEvents.h> Apple Event Manager

OSErr AEGetSpecialHandler ( functionClass, handler,isSysHandler );

AEKeyword functionClass ; keyword for special handler being gotten

ProcPtr * handler ; pointer to special handler routine

Boolean isSysHandler ; TRUE = taken from system handler table

FALSE = taken from application handler table

returns Error Code; 0 = no error

The AEGetSpecialHandler function returns a specified special handler.

The functionClass parameter is the keyword that specifies the desired special

handler. There is currently only one value allowed for this parameter: the

keyPreDispatch constant, which identifies a handler routine that is called

immediately before the Apple Event Manager dispatches an Apple event.

The function returns a pointer to the special handler in the handler

parameter.

The isSysHandler parameter specifies the special handler table from which to

get the handler. If its value is TRUE, the handler is taken from the system

handler table. If its value is FALSE, the handler is taken from the application

handler table.

Result codes

noErr (0) No error

memFullErr (-108) Not enough room in heap zone

errAENotASpecialFunction (-1714) Wrong keyword for a special function

Referenced by (2):